=============================================================================
ac'tivAid
=============================================================================
Version:            0.9.3
Date:               2005-06-2
Author:             Wolfgang Reszel fr c't
E-Mail:             se@ctmagazin.de (Stephan Ehrmann)
Copyright:          Heise Zeitschriften Verlag GmbH & Co. KG
AutoHotkey Version: 1.0.32.00 (aktiv: ###)
Language:           Deutsch
Testplatform:       WinXP
-----------------------------------------------------------------------------

!!! WICHTIG:
!!! ac'tivAid.ahk funktioniert nur mit AutoHotkey ab Version 1.0.32.00.
!!! http:/www.autohotkey.com/download

Dies ist eine Zusammenstellung verschiedener ntzlicher AutoHotkey-Skripte,
die einem die tgliche Arbeit am Computer erleichtern.
Nach dem Starten befindet sich ein rotes c't-Symbol rechts in der Taskleiste.
ber die rechte Maustaste erreicht man ein Kontextmen, mit welchem sich die
Funktionen einzeln ein-/ausschalten lassen. Ac'tivAid funktioniert
parallel zu NiftyWindows mit der einzigen Einschrnkung dass nur eines von
beiden seine Funktionen auf die mittlere Maustaste legen kann. Dazu muss man
gegenseitig die Funktion aktivieren und deaktivieren. Falls man gelegentlich
zwischen beiden Funktionen wechseln mchte, lsst man die mittlere Maustaste
in NiftyWindows immer aktiv und de-/aktiviert MouseClip in ac'tivAid.
ndert man manuell Einstellungen in der zu ac'tivAid gehrenden INI-Datei,
muss es ber das Tray-Men neu geladen werden, damit die nderungen
angenommen werden.
Ac'tivAid lsst sich ber das Internet aktualisieren. Gelegentlich sollte
man also die Update-Funktion aufrufen oder die automatiche Prfung im
Informations-Fenster aktivieren. nderungen am Skript gehen dabei verloren,
Einstellungen aus der INI-Datei werden aber nicht berschrieben.
Um ac'tivAid zu erweitern, ohne dass die nderungen bei einem Update
berschrieben werden, muss man seine Erweiterungen im Include-Verzeichnis
ablegen. Nheres dazu am Ende dieser Readme.

Win+Shift+ESC      - Deaktiviert alle Funktionen von ac'tivAid
oder CapsLock+ESC
oder Doppelklick
auf c't-Symbol

Win+Shift+#        - Fhrt eine Problembehebung aus, die 'festsitzende'
oder CapsLock+#      Tasten lst.

=============================================================================
bersicht aller integrierten Funktionen:
=============================================================================

-----------------------------------------------------------------------------
ComfortDrag - interaktives Wechseln der Fenster
-----------------------------------------------------------------------------
Vereinfacht das Kopieren und Verschieben von Dateien, besonders wenn
viele Fenster geffnet sind. Verschiebt man Dateien im Explorer oder aus
einem Programm in den Explorer, wird nach kurzer Zeit das Fenster unter der
Maus aktiviert. Zudem lassen sich Fenster bei gedrckt gehaltener
linker Maustaste mit der rechten Maustaste temporr ausschalten. Sobald die
linke Maustaste losgelassen wird, werden die Fenster wiederhergestellt.
Letzteres klappt bei Browsern (wegen Kompatibilitt zu Mausgesten) nur wenn
die Maus auf der Titelleiste liegt (konfigurierbar).
Anwendungen die mit ComfortDrag Probleme bereiten knnen in der ac'tivAid.ini
unter [ComfortDrag] mit der Variable ExcludeApps von ComfortDrag
ausgeschlossen werden. Die Eintrge werden mit einem Komma ohne Leerzeichen
getrennt und beziehen sich auf einen Teil des Fenstertitels.
Beispiel: ExcludeApps =Opera,Adobe

Folgende Krzel lassen sich bei gedrckter linker Maustaste nutzen.

ESC                - Stellt die Fensteranordnung wieder her und bricht einen
                     Vorgang ab.

rechte Maustaste   - Blendet das Fenster unter der Maus aus, funktioniert
Bild Hoch            auch, wenn man auf dem Fenstertitel mit der linken und
                     rechten Maustaste klickt. Beim Loslassen beider Maus-
                     Tasten wird der Ursprungszustand hergestellt.

Shift              - Hlt man beim Loslassen der Maustasten die Shift-Taste
                     gedrckt, bleibt das Fenster unter der Maus aktiviert.
                     Somit kann man sich sozusagen ein Fenster 'raussuchen'.

mittlere Maustaste - Stellt einzeln mit der rechten Maustaste versteckte
Bild Runter          Fenster wieder her. Werden keine Fenster versteckt, wird
                     das Fenster unter der Maus aktiviert und falls es
                     schon aktiviert war, wird das verdeckte Fenster
                     darunter hervorgeholt.

Shift + ShiftLock  - Zeigt kurzfristig den Desktop, was auch beim Kopieren
(Feststellen-Taste)  funktioniert. Drckt man das Krzel nochmals, erscheinen
                     die Fenster wieder, was ebenso nach dem zweiten
                     Mausklick passiert.

Strg               - Aktiviert bei einer Drag'n'Drop-Aktion direkt (also
                     ohne Verzgerung) das Fenster unter der Maus.

-----------------------------------------------------------------------------
MouseClip - Kopieren/Einfgen mit der Maus
-----------------------------------------------------------------------------
Ist ein Wort markiert und man drckt die mittlere Maustaste an einer
anderen Stelle, wird dort automatisch das markierte Wort hinkopiert.
Ist kein Wort markiert, wird der Inhalt der Zwischenablage eingefgt.
Hlt man die mittlere Maustaste gedrckt, lsst sich damit Text
markieren, welcher dann beim Loslassen automatisch kopiert wird.

-----------------------------------------------------------------------------
FilePaste - kopierte Dateien als Text einfgbar (Strg+Alt+Shift+V)
-----------------------------------------------------------------------------
Hat man im Explorer Dateien mit Strg+C kopiert, kann man deren Dateinamen
als Text in einer beliebigen Anwendung mit Strg+Alt+Shift+V wieder
einfgen. Kann auch dazu genutzt werden, formatierten Text
unformatiert einzufgen (z.B. innerhalb von InDesign oder Illustrator).

Strg+Alt+Shift+V   - den reinen Textinhalt der Zwischenablage einfgen
                     z.B. im Explorer kopierte Dateien werden dann
                     als Dateinamen eingefgt.

-----------------------------------------------------------------------------
NewFolder - Strg+N erstellt neue Ordner
-----------------------------------------------------------------------------
Im Explorer, Dateidialogen und auf dem Desktop kann man mit
Strg+N direkt einen neuen Ordner anlegen.

Strg+N             - Neuen Ordner im Explorer anlegen

-----------------------------------------------------------------------------
WebSearch - Internet-Recherche
-----------------------------------------------------------------------------
Markierter Text aus fast jeder Anwendung wird an eine Suchmaschine im
Internet weitergeben. Mit Win+W ruft man den Dialog auf, wo man entscheiden
kann, bei welcher Suchmaschine gesucht werden soll. Der Dialog enthlt
ein Bearbeiten-Men, wo sich Eintrge bearbeiten, hinzufgen und lschen
lassen. Im Bearbeiten/Hinzufgen-Dialog wird dabei automatisch das Favicon
ermitteln und ggf. runtergeladen. Zum schnellen Zugriff auf die
Suchmaschinen kann man sie mit Alt-Krzeln belegen. Dazu muss man ein &
vor dem gewnschten Buchstaben stellen. Z.B. G&oogle bedeutet, dass man
mit Alt+o darauf zugreifen kann. Alle Einstellungen und Icons werden im
Unterordner WebSearch abgelegt. Die Option, dass der Suchbegriff kodiert
weitergegeben wird, ist nur fr Opera ntzlich, wenn es Probleme mit
der bertragung von Umlauten gibt. Mchte man die Suchergebnis in einem
anderen als den Standardbrowser anzeigen lassen, kann man das im Bearbeiten-
Men einstellen.

Win+W		       - Startet den Dialog zu WebSearch
oder CapsLock+W

-----------------------------------------------------------------------------
LikeDirkey - Ordnerkrzel auf Ziffernblock
-----------------------------------------------------------------------------
Mit LikeDirkey kann man die Tasten Win+0 - Win+9 und Strg+0 - Strg+9
mit Verzeichnissen belegen. Ruft man ein Win-Krzel auf, wird immer
ein neues Explorer-Fenster geffnet.
Bei Strg wird versucht im entsprechenden Fenster das Verzeichnis zu
wechseln. Mit Strg+Win+0 - 9 kann man direkt aus dem
Explorer die Tasten neu belegen. Es heit LikeDirkey, weil es ein hnliches
Freeware-Tool namens Dirkey gibt.
Damit das Skript mit NiftyWindows zusammenarbeitet, sind standardmig nur
die Zahlen des Ziffernblocks zu verwenden. Man kann das aber im Tray-Men
auf die Ziffernreihe umkonfigurieren.

Win + 0-9       - Explorer mit dem gespeicherten Ordner ffnen

Strg + 0-9      - Im aktuellen Fenster zum gespeicherten Ordner wechseln

Strg+Win + 0-9  - Speichert den aktuellen Ordner auf ein Krzel
                  (nur im Explorer)

Win/Strg +      - Listet alle gespeichertet Verzeichnisse in einem
  		  Kontextmen auf.
		  (nur mit der Erweiterung LikeDirkeyMenu, siehe unten)


-----------------------------------------------------------------------------
CommandLine - Explorer Adressleiste als Kommandozeile
-----------------------------------------------------------------------------
Tippt man in die Adresszeile des Explorers ein < gefolgt von einem Dos-Befehl
ein, wird dieser in der Commando-Ebene ausgefhrt. Setzt man dem Befehl zwei
<< voran, wird dieser versteckt ausgefhrt.

<		   - in der Adresszeile des Explorers: Startet Kommandozeile

-----------------------------------------------------------------------------
Problembehebung (Win+Shift+#)
-----------------------------------------------------------------------------
Auf AutoHotkey basierende Tools schleppen natrlich auch alle Bugs mit, die
AutoHotkey selber hat. So kann es unter umstnden passieren, dass z.B. nach
wilden Skalierungen mit NiftyWindows windows-intern die Strg-Taste weiter
gedrckt bleibt, obwohl man sie losgelassen hat. Das hat zur Folge, dass man
beim normalen Tippen pltzlich Funktionen des aktiven Programms aufruft.
Sollte dieses Problem einmal auftreten, versucht diese Funktion von
ac'tivAid dies zu beheben. Sie ist auch direkt ber Win+Shift+# zu erreichen.

Win+Shift+#        - Problembehebung aufrufen
oder CapsLock+#




=============================================================================
Weitere Zusatzfunktion aus dem Include-Verzeichnis
=============================================================================

Die folgenden Funktionen lassen sich in den Dateien header.ahk und main.ahk
im Include-Verzeichnis von ac'tivAid aktivieren. Dazu muss man die bei der
Funktionsbeschreibung angegebenen Zeilen zu den Dateien hinzufgen. Ggf.
muss die Zahl in der eckigen Klammer angepasst werden.
Deaktivieren lassen sie sich, indem man ein Semikolon vor die entsprechenden
Zeilen setzt und ac'tivAid neu ldt. Anders als ber die Deaktivierung im
Tray-Men, wird somit die Funktion nicht geladen und belegt auch keinen
Speicher. Erweiterung werden bei der Exe-Version von ac'tivAid erst
verfgbar, wenn es neu kompiliert wird.

-----------------------------------------------------------------------------
[8] WindowToBottom - Fenster nach hinten
-----------------------------------------------------------------------------
Klickt man mit der mittleren Maustaste auf die Titelleiste eines Fensters,
wird es  in den Hintergrund gelegt.

header.ahk: Function[8]  = WindowToBottom
main.ahk  : #Include include\ac'tivAid_WindowToBottom.ahk

-----------------------------------------------------------------------------
[9] LikeDirkeyMenu
-----------------------------------------------------------------------------
Erweitert LikeDirkey, so dass man mit (Strg+)Win+Plus alle Verzeichniskrzel
als Kontext-Men aufgelistet bekommt.

header.ahk: Function[9]  = LikeDirkeyMenu
main.ahk  : #Include include\ac'tivAid_LikeDirkey-Menu.ahk

-----------------------------------------------------------------------------
[10] WebSearchOnMButton
-----------------------------------------------------------------------------
Ist MouseClip aktiviert, wird ber die mittlere Maustaste WebSearch
aufgerufen. Ac'tivAid muss danach neu geladen werden.
Um diese Funktion zu aktivieren, muss man im Include-Verzeichnis von
ac'tivAid in den Dateien header.ahk und main.ahk das Semikolon vor
Function... und #Include... entfernen.

header.ahk: Function[10]  = WebSearchOnMButton
main.ahk  : #Include include\ac'tivAid_WebSearch on MButton.ahk

=============================================================================
Integration eigener Funktionen
=============================================================================

Zur Integration eigener Skripte sollte man folgendes beachten:
- Alle Variablen und Unterroutinen sollten mit einem eindeutigen noch
  nicht verwendeten Krzel beginnen, damit sich keine Funktion in die
  Quere kommt. Globale Variablen werden ohne Krze angegeben, allerdings
  besteht bei globalen Variablen keine Garantie fr den Inhalt.
- Die Funktion muss einen Namen ohne Leerzeichen haben.
- Fr die Integration ins Tray-Men muss die Liste mit Function[x] ...
  ergnzt werden. Dort gibt man den Skriptnamen an.
- Die Funktion bentigt eine Unterroutine die mit init_ beginnt und mit
  dem Funktionsnamen endet. Der Name muss identisch mit dem Namen bei
  Funktion[x] sein. Dort muss eine Variable MenuName ohne Krzel angelegt
  werden. Die Standard-Funktionen machen das abhngig von der Systemsprache.
- Alle Hotkeys sollten in den globalen Hotkey-Bereich ausgegliedert werden
  und von zwei Kommentaren ;---Funktion---> ;<---Funktion--- eingeschlossen
  werden.
- Alles zur Funktion gehrende sollte mit diesen Kommentaren umgeben werden
  Zur Prfung, ob die Funktion im Men aktiviert ist oder nicht, gibt es
  automatisch die Variable Enable_FunktionsName, welche den Wert yes oder no
  enthlt und dann auch automatisch in die INI-Datei aufgenommen wird.
- Bentigt eine Funktion Untermens, muss in der Variable SubMenu der
  Menname angegeben werden, In FunktionsName_EnableMenu steht der Name
  des ersten Menpunkts der zum de-/aktivieren der Funktion ntig ist.
  Dieser sollte im spter erstellten Untermen der erste Menpunkt sein.
  SubMenu und MenuName mssen bei Untermens noch in Krzel_MenuName und
  Krzel_SubMenu gesichert werden, damit sie in der Funktion verwendet
  werden knnnen. Ein Beispiel fr ein Untermen ist LikeDirkey
- Folgende globalen Variablen stehen fr eigene Funktionen zur Verfgung:
  ScriptName        - Name des gesamten Skripts (ac'tivAid)
  ScriptNameClean   - Name ohne Sonderzeichen (fr die INI-Sektion)
  ScriptVersion     - Version des gesamten Skripts
  ScriptTitle       - Fenstertitel fr Dialoge
  ConfigFile        - Name der INI-Datei
- Sprachabhngige Variablen:
  lng_exit          = Beenden
  lng_Left          = linke
  lng_Right         = rechte
  lng_MouseButton   = Maustaste
  lng_Win           = Windows-Taste
  lng_Alt           = Alt-Taste
  lng_Shift         = Shift-Taste
  lng_Ctrl          = Strg-Taste
  lng_ScriptReload  = %ScriptName% aktualisiert.
  lng_Readme        = Informationen
  lng_Changelog     = nderungen
  lng_Select        = &Durchsuchen ...
- Von ac'tivAid belegte Hotkeys knnen um eigene Funktionen ergnzt werden,
  wenn man im init-Bereich der eigenen Funktion die Variable Extend_Hotkey
  mit dem Namen der Unterroutine belegt. Hotkey ist dabei durch den Namen
  des Hokteys zu ersetzen, also Extend_CtrlW erweitert das Hotkey fr
  WebSearch.

Seit Version 0.9.1 gibt es zu ac'tivAid ein Unterverzeichnis include, wo
sich zwei Skripte (main, header) befinden, die es ermglichen, ac'tivAid mit
eigenen Funktionen zu erweitern, ohne dass man auf das automatische Update
verzichten muss. Wird in header.ahk die Variable CustomIncludes auf yes
gesetzt, werden bei einem update die beiden Skripte (main, header) nicht
berschrieben. Genaueres steht in den Skriptkommentaren.
Seit Version 0.9.2 gibt es auch Beispielskripte (siehe weiter oben). Diese
werden bei einem Update berschrieben. Falls eigene Anpassungen vorgenommen
wurden, mssen die Dateien umbenannt werden und dem entsprechend main.ahk
angepasst werden.
